home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / dglope.z / dglope
Encoding:
Text File  |  2002-10-03  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddggggllllooooppppeeee((((3333GGGG))))                                                          ddddggggllllooooppppeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddggggllllooooppppeeee - opens a Graphics Library connection to a graphics server
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      iiiinnnntttteeeeggggeeeerrrr****4444 ddddggggllllooooppppeeee((((ssssvvvvnnnnaaaammmmeeee,,,, lllleeeennnnggggtttthhhh,,,, ttttyyyyppppeeee))))
  13.      cccchhhhaaaarrrraaaacccctttteeeerrrr****((((****)))) ssssvvvvnnnnaaaammmmeeee
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 lllleeeennnnggggtttthhhh,,,, ttttyyyyppppeeee
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _s_v_n_a_m_e   expects a variable containing the name of the graphics server to
  18.               which you want to open a connection.
  19.  
  20.               For a successful connection, the client host must have
  21.               permission to connect to the graphics server.  Authentication is
  22.               accomplished via the same mechanisms as for X clients.  See
  23.               xhost(1) for further details.
  24.  
  25.               The _s_v_n_a_m_e parameter has the following syntax:
  26.  
  27.               [[_u_s_e_r_n_a_m_e ]_p_a_s_s_w_o_r_d@]_h_o_s_t_n_a_m_e[:_s_e_r_v_e_r[._s_c_r_e_e_n]]
  28.  
  29.               where _h_o_s_t_n_a_m_e is an internet host name recognized by
  30.               gethostname(3N).  _s_e_r_v_e_r and _s_c_r_e_e_n are ignored, and both are
  31.               set to 0.
  32.  
  33.               For DECnet connections, if the server account has a password,
  34.               this password must be specified by including _u_s_e_r_n_a_m_e and
  35.               _p_a_s_s_w_o_r_d.  This password is used only for opening the DECnet
  36.               connection; the local and remote accounts must still be
  37.               equivalent in the _r_l_o_g_i_n sense.
  38.  
  39.      _l_e_n_g_t_h   expects the length of the string in _s_v_n_a_m_e.
  40.  
  41.      _t_y_p_e     expects a symbolic constant that specifies the kind of
  42.               connection.  There are three defined constants for this
  43.               parameter:
  44.  
  45.               DDDDGGGGLLLLLLLLOOOOCCCC indicates a direct connection to the local graphics
  46.               hardware.  This type of connection is not supported on client
  47.               machines without IRIS graphics hardware.
  48.  
  49.               DDDDGGGGLLLLTTTTSSSSOOOO indicates a remote connection via TCP/IP.
  50.  
  51.               DDDDGGGGLLLL4444DDDDDDDD indicates a remote connection via DECnet.
  52.  
  53. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  54.      If the connection succeeds, the returned value of the function is a non-
  55.      negative integer, _s_e_r_v_e_r_i_d, that identifies the graphics server.  If the
  56.      connection failed, the returned value for the function is a negative
  57.      integer.  The absolute value of a negative returned value is either a
  58.      standard error value (defined in <_e_r_r_n_o._h>) or one of several error
  59.      returns associated specifically with ddddggggllllooooppppeeee:
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddggggllllooooppppeeee((((3333GGGG))))                                                          ddddggggllllooooppppeeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      EEEENNNNOOOODDDDEEEEVVVV      _t_y_p_e is not a valid connection type.
  75.  
  76.      EEEEAAAACCCCCCCCEEEESSSS      login incorrect or permission denied.
  77.  
  78.      EEEEMMMMFFFFIIIILLLLEEEE      too many graphics connections are currently open.
  79.  
  80.      EEEENNNNOOOOPPPPRRRROOOOTTTTOOOOOOOOPPPPTTTT DGL service not found in ////eeeettttcccc////sssseeeerrrrvvvviiiicccceeeessss.
  81.  
  82.      EEEERRRRAAAANNNNGGGGEEEE      invalid or unrecognizable number representation.
  83.  
  84.      EEEEPPPPRRRROOOOTTTTOOOONNNNOOOOSSSSUUUUPPPPPPPPOOOORRRRTTTT
  85.                  DGL version mismatch.
  86.  
  87.      EEEESSSSRRRRCCCCHHHH       the window manager is not running on the server.
  88.  
  89. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  90.      ddddggggllllooooppppeeee opens a Graphics Library connection to a graphics server (_s_v_n_a_m_e).
  91.      After a connection is open, all graphics preferences, input, and output
  92.      are directed to that connection.  This direction is continued until
  93.      either the connection is closed, another connection is opened, or a
  94.      different connection is selected.  A different connection can be selected
  95.      by calling a subroutine that takes a graphics window identifier as an
  96.      input parameter, e.g. wwwwiiiinnnnsssseeeetttt.  The server connection associated with that
  97.      graphics window identifier becomes the current connection.  To close a
  98.      connection, call ddddggggllllcccclllloooo with the server identifier returned by ddddggggllllooooppppeeee.
  99.  
  100.      If a remote server error occurs, the graphics application may exit with a
  101.      status value EIO and produce the following error message:
  102.  
  103.           dgl error (comm): read returned 0
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      dglclo, finish, gflush, winope, winset, scrnse
  107.  
  108.      rlogin(1C), gethostbyname(3N) in the _I_R_I_S-_4_D _U_s_e_r'_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l
  109.  
  110. NNNNOOOOTTTTEEEESSSS
  111.      This routine is available only in immediate mode.
  112.  
  113.      This routine is available in both the GL and DGL libraries.  However, the
  114.      DDDDGGGGLLLLLLLLOOOOCCCC connection type is not supported by the DGL library.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.